home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / maximus / dllog_13.zip / DLLOG.DOC next >
Text File  |  1991-11-20  |  4KB  |  120 lines
  1.  
  2.  
  3.                                DLLog v1.3
  4.  
  5.                A Download Log Reporter for Maximus-CBCS
  6.  
  7.  
  8.  
  9. INTRODUCTION AND DISCLAIMER
  10.  
  11. DLLog v1.3 extracts download information from Maximus 2.0 log files
  12. and writes them to a file specified by you. The output file has a
  13. format similar to the UL.LOG file generated by Maximus. DLLog will
  14. work with multi-line systems, accepting input from multiple log files,
  15. and will merge and sort the output chronologically.
  16.  
  17. The program and this document are copyright 1990, 1991, by John H. Cuccia.
  18.  
  19. There is no charge for use of this program. It may be distributed
  20. freely, but no fees can be charged for distributing it.
  21.  
  22.  
  23.  
  24. WARRANTY
  25.  
  26. Surely you jest. This program carries no warranties of any kind, either
  27. express or implied. If it reformats your hard drive, think of it as an
  28. opportunity to get rid of all those old files you never use any more.
  29. The author is not responsible for any damage done by this program.
  30.  
  31.  
  32.  
  33. HOW IT WORKS
  34.  
  35. DLLog is intended to be run in a batch file. I run it during my nightly
  36. maintenance.
  37.  
  38. The program requires two types of command line parameters: input file
  39. specifications and an output file spec.  An optional command line
  40. switch can be used to modify the program's default behavior.
  41.  
  42. Input file specs are preceded with a /i and output files with a /o.
  43.  
  44. The optional /q switch tells DLLog to include any QWK packets that may
  45. have been downloaded in the output file listing.  By default, DLLog
  46. ignores QWK downloads.
  47.  
  48. Note that a dash (-) can be used interchangeably with the slash (/) as
  49. the command line switch character.
  50.  
  51. Some examples will best illustrate how the program works.
  52.  
  53.  
  54. If you're like me and run a single line system from C:\Max, do this:
  55.  
  56.     DLLog /imax.log /odl.log /q
  57.  
  58. The above command tells DLLog to read a file called max.log, to output
  59. to a file called dl.log, and to include QWK packets in the listing.
  60.  
  61.  
  62. You can call DLLog from any directory, but if you're not in the
  63. directory that your log files live in, you have to specify a path:
  64.  
  65.     DLLog /ic:\max\max.log /oc:\max\logs\dl.log
  66.  
  67.  
  68. You can use a dash as the switch character if you prefer, so this is a
  69. valid command line:
  70.  
  71.     DLLog -imax.log -odl.log -q
  72.  
  73.  
  74. For multi-line systems, the /i parameter accepts wildcards:
  75.  
  76.     DLLog /imax??.log /odl.log
  77.  
  78. or,
  79.  
  80.     DLLog /imax*.log /odl.log /q
  81.  
  82.  
  83. Finally, if for some reason you keep your BBS log files in separate
  84. directories, you can do this:
  85.  
  86.     DLLog /ic:\max1\max1.log /ic:\max2\max2.log /odl.log /q
  87.  
  88. or,
  89.  
  90.     DLLog /ic:\max\max*.log /ic:\max1\max*.log /oc:\max\dl.log
  91.  
  92.  
  93. You can specify as many input log files as you can squeeze on the
  94. command line this way. Using wildcards, DLLog can process up to 31 log
  95. files in a single run. This way you can process a months worth of logs
  96. at a time (though I have no earthly idea why you'd do this).
  97.  
  98. When DLLog runs, it checks for the existence of the specified output
  99. file. If it exists, output will be appended to it. If the file doesn't
  100. exist, the program will create it.
  101.  
  102. Note that you can only specify one output file. If you need more, you'll
  103. need to make multiple runs.
  104.  
  105. BUGS
  106.  
  107. Please report any bugs or problems to me at 1:3803/1, or in Muffin, the
  108. international Maximus support echo. If you're not a Fido node, and don't
  109. have access to the echo, you can call my BBS at 318-235-3207.
  110.  
  111. If you use the program and like it drop me a note. It's nice to know
  112. when people find this stuff useful.
  113.  
  114.  
  115.  
  116. John Cuccia
  117. 1:3803/1
  118. Nov 18, 1991
  119.  
  120.